home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / Shell.z / Shell
Encoding:
Text File  |  2003-11-18  |  9.1 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      SSSShhhheeeellllllll((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             SSSShhhheeeellllllll((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _S_h_e_l_l    - The Shell widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       #include <Xm/Xm.h>
  13.       #include <X11/Shell.h>
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.       Shell    is a top-level widget (with only one managed child)
  17.       that encapsulates the    interaction with the window manager.
  18.  
  19.       At the time the shell's child    is managed, the    child's    width
  20.       is used for both widgets if the shell    is unrealized and no
  21.       width    has been specified for the shell.  Otherwise, the
  22.       shell's width    is used    for both widgets.  The same relations
  23.       hold for the height of the shell and its child.
  24.  
  25.     CCCCllllaaaasssssssseeeessss
  26.       Shell    inherits behavior and resources    from _C_o_m_p_o_s_i_t_e and
  27.       _C_o_r_e.
  28.  
  29.       The class pointer is _s_h_e_l_l_W_i_d_g_e_t_C_l_a_s_s.
  30.  
  31.       The class name is _S_h_e_l_l.
  32.  
  33.     NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  34.       The following    table defines a    set of widget resources    used
  35.       by the programmer to specify data.  The programmer can also
  36.       set the resource values for the inherited classes to set
  37.       attributes for this widget.  To reference a resource by name
  38.       or by    class in a .Xdefaults file, remove the _X_m_N or _X_m_C
  39.       prefix and use the remaining letters.     To specify one    of the
  40.       defined values for a resource    in a .Xdefaults    file, remove
  41.       the _X_m prefix    and use    the remaining letters (in either
  42.       lowercase or uppercase, but include any underscores between
  43.       words).  The codes in    the access column indicate if the
  44.       given    resource can be    set at creation    time (C), set by using
  45.       _X_t_S_e_t_V_a_l_u_e_s (S), retrieved by    using _X_t_G_e_t_V_a_l_u_e_s (G), or is
  46.       not applicable (N/A).
  47.  
  48.                           SSSShhhheeeellllllll RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  49.      NNNNaaaammmmeeee               CCCCllllaaaassssssss             TTTTyyyyppppeeee              DDDDeeeeffffaaaauuuulllltttt       AAAAcccccccceeeessssssss
  50.      ____________________________________________________________________________________________________
  51.      XmNallowShellResize       XmCAllowShellResize     Boolean          False           CG
  52.      XmNcreatePopupChildProc   XmCCreatePopupChildProc     XtCreatePopupChildProc      NULL           CSG
  53.      XmNgeometry           XmCGeometry         String              NULL           CSG
  54.      XmNoverrideRedirect       XmCOverrideRedirect     Boolean          False           CSG
  55.      XmNpopdownCallback           XmCCallback         XtCallbackList          NULL           C
  56.      XmNpopupCallback           XmCCallback         XtCallbackList          NULL           C
  57.      XmNsaveUnder           XmCSaveUnder         Boolean          False           CSG
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSShhhheeeellllllll((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             SSSShhhheeeellllllll((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      XmNvisual               XmCVisual         Visual    *          CopyFromParent   CSG
  75.  
  76.  
  77.       _X_m_N_a_l_l_o_w_S_h_e_l_l_R_e_s_i_z_e
  78.            Specifies that if this resource is False, the Shell
  79.            widget instance returns _X_t_G_e_o_m_e_t_r_y_N_o to all geometry
  80.            requests    from its children.
  81.  
  82.       _X_m_N_c_r_e_a_t_e_P_o_p_u_p_C_h_i_l_d_P_r_o_c
  83.            Specifies the pointer to    a function that    is called when
  84.            the Shell widget    instance is popped up by _X_t_P_o_p_u_p.  The
  85.            function    creates    the child widget when the shell    is
  86.            popped up instead of when the application starts    up.
  87.            This can    be used    if the child needs to be reconfigured
  88.            each time the shell is popped up.  The function takes
  89.            one argument, the popup shell, and returns no result.
  90.            It is called after the popup callbacks specified    by
  91.            _X_m_N_p_o_p_u_p_C_a_l_l_b_a_c_k.
  92.  
  93.       _X_m_N_g_e_o_m_e_t_r_y
  94.            Specifies the desired geometry for the widget instance.
  95.            This resource is    examined only when the widget instance
  96.            is unrealized and the number of its managed children is
  97.            changed.     It is to change the values of the _X_m_N_x, _X_m_N_y,
  98.            _X_m_N_w_i_d_t_h, and _X_m_N_h_e_i_g_h_t resources.
  99.  
  100.       _X_m_N_o_v_e_r_r_i_d_e_R_e_d_i_r_e_c_t
  101.            Specifies this is True if the widget instance is    a
  102.            temporary window    which should be    ignored    by the window
  103.            manager.     Applications and users    should not normally
  104.            alter this resource.
  105.  
  106.       _X_m_N_p_o_p_d_o_w_n_C_a_l_l_b_a_c_k
  107.            Specifies a list    of callbacks that is called when the
  108.            widget instance is popped down by _X_t_P_o_p_d_o_w_n.
  109.  
  110.       _X_m_N_p_o_p_u_p_C_a_l_l_b_a_c_k
  111.            Specifies a list    of callbacks that is called when the
  112.            widget instance is popped up by _X_t_P_o_p_u_p.
  113.  
  114.       _X_m_N_s_a_v_e_U_n_d_e_r
  115.            Specifies a True    value if it is desirable to save the
  116.            contents    of the screen beneath this widget instance,
  117.            avoiding    expose events when the instance    is unmapped.
  118.            This is a hint, and an implementation may save contents
  119.            whenever    it desires, including always or    never.
  120.  
  121.       _X_m_N_v_i_s_u_a_l
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      SSSShhhheeeellllllll((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             SSSShhhheeeellllllll((((3333XXXX))))
  137.  
  138.  
  139.  
  140.            Specifies the visual used in creating the widget.
  141.  
  142.     IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  143.       Shell    inherits behavior and resources    from the following
  144.       superclass.  For a complete description of each resource,
  145.       refer    to the man page    for that superclass.
  146.  
  147.                  CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee    SSSSeeeetttt
  148.      NNNNaaaammmmeeee         CCCCllllaaaassssssss             TTTTyyyyppppeeee       DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  149.      ______________________________________________________________________
  150.      XmNchildren     XmCReadOnly         WidgetList       NULL         G
  151.      XmNinsertPosition     XmCInsertPosition   XtOrderProc   NULL         CSG
  152.      XmNnumChildren     XmCReadOnly         Cardinal       0         G
  153.  
  154.  
  155.                            CCCCoooorrrreeee    RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  156.      NNNNaaaammmmeeee                 CCCCllllaaaassssssss                 TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt             AAAAcccccccceeeessssssss
  157.      ______________________________________________________________________________________________________________
  158.      XmNaccelerators             XmCAccelerators             XtAccelerators   dynamic             CSG
  159.      XmNancestorSensitive         XmCSensitive             Boolean          dynamic             G
  160.      XmNbackground             XmCBackground             Pixel          dynamic             CSG
  161.      XmNbackgroundPixmap         XmCPixmap                 Pixmap          XmUNSPECIFIED_PIXMAP   CSG
  162.      XmNborderColor             XmCBorderColor             Pixel          XtDefaultForeground    CSG
  163.      XmNborderPixmap             XmCPixmap                 Pixmap          XmUNSPECIFIED_PIXMAP   CSG
  164.      XmNborderWidth             XmCBorderWidth             Dimension          1                 CSG
  165.      XmNcolormap             XmCColormap             Colormap          dynamic             CG
  166.      XmNdepth                 XmCDepth                 int          dynamic             CG
  167.      XmNdestroyCallback             XmCCallback             XtCallbackList   NULL             C
  168.      XmNheight                 XmCHeight                 Dimension          dynamic             CSG
  169.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True             C
  170.      XmNmappedWhenManaged         XmCMappedWhenManaged         Boolean          True             CSG
  171.      XmNscreen                 XmCScreen                 Screen *          dynamic             CG
  172.      XmNsensitive             XmCSensitive             Boolean          True             CSG
  173.      XmNtranslations             XmCTranslations             XtTranslations   dynamic             CSG
  174.      XmNwidth                 XmCWidth                 Dimension          dynamic             CSG
  175.      XmNx                 XmCPosition             Position          0                 CSG
  176.      XmNy                 XmCPosition             Position          0                 CSG
  177.  
  178.  
  179.     TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  180.       There    are no translations for    Shell.
  181.  
  182.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  183.       _C_o_m_p_o_s_i_t_e(_3_X)    and _C_o_r_e(_3_X).
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 11/11/03)
  196.  
  197.  
  198.  
  199.